home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / os2 / et29b3.zip / readme.1st < prev   
Text File  |  1996-10-04  |  50KB  |  1,062 lines

  1. This is the 'official' release of the 3rd beta of Electronic Teller 2.9,
  2. release version 2.9b3.
  3.  
  4. CONTENTS:
  5.  
  6.     - Introduction (purpose behind beta)
  7.     - Installation
  8.     - Files
  9.     - Migration (using pre-2.9 accounts in 2.9)
  10.     - Importing (from QIF files)
  11.     - Usage (usage issues discussed briefly)
  12.     - Service Desk 
  13.     - Account Book 
  14.     - Creating Transactions 
  15.     - Postdating Transactions 
  16.     - Editing Transactions 
  17.     - Reconciling (Balancing) Accounts 
  18.     - Drag and Drop 
  19.     - First aid 
  20.     - Budgets
  21.     - Reports
  22.     - Transaction fees
  23.     - Cheque printer
  24.     - Searching & replacing
  25.  
  26.  
  27.                            INTRODUCTION 
  28.                            ~~~~~~~~~~~~ 
  29.  
  30. This is the third and likely final ET beta.  2.9b3 contains some bug fixes 
  31. as well as the rest of the functionality to bring it up to speed with 
  32. 2.80a, noteably reports, transactions fees, an updated cheque printer, and 
  33. a search-and-replace function.
  34.  
  35. If you find a bug in this version, please report it by sending e-mail to
  36.  
  37.                         phcaron@travel-net.com
  38.  
  39. Also, try to provide as much information as you can about the bug:  what
  40. led to it; can it be reproduced easily; how severe was it, etc.  I'm also
  41. interested in knowing what users' opinions are.  Many fundamental changes
  42. have been made to the interface in various aspects, all in the hopes of
  43. making ET a little more user-friendly.  I may still have got things
  44. wrong-headed, so, please, don't be shy.  Make your opinions known.
  45.  
  46.  
  47. Please note that the information in this file is by no means complete.  It
  48. provides a *brief* introduction to 2.9 -- nothing more.
  49.  
  50.  
  51.                                INSTALLATION
  52.                                ~~~~~~~~~~~~
  53. Unzip the files in the archive to a directory and run the install.cmd Rexx
  54. script.  You will be asked to supply a destination directory.  If you have
  55. 2.9b1 or 2.9b2 installed, you may install over that version.  See the 
  56. 'MIGRATION' topic below.
  57.  
  58. NOTE:  it's always a good idea to back up the ATM cards when installing
  59. over a previous version.
  60.  
  61. If you are running a version earlier than the first 2.9b1, you must export
  62. your existing ET accounts and reimport them using the QIF Converter (see
  63. 'MIGRATION' below for additional information).
  64.  
  65.  
  66.                                    FILES
  67.                                    ~~~~~
  68. Included in the archive are the following files.  Depending upon your
  69. needs, some may be safely deleted.  Files that are essential are prepended
  70. with an asterisk (*); runtime dynamic link libraries are not included,
  71. here:
  72.  
  73.     *etbook.exe    Account Book 
  74.     etbuds.exe     Budget graphs / printing 
  75.     etcalc.exe     Calculator 
  76.     etcald.exe     Calendar and reminder utility
  77.     *etdesk.exe    Service Desk 
  78.     etprnc.exe     Cheque printer/designer
  79.     etqifie.exe    QIF Converter (essential in importing pre-2.9 accounts) 
  80.     restini.exe    'etdeskf.ini' INI restoration utility
  81.  
  82.     
  83.                                  MIGRATION
  84.                                  ~~~~~~~~~
  85. A migration routine has been added to 2.9b2.  It's primary purpose is to
  86. rearrange the data in the individual *.REC files for each ATM card to
  87. accommodate a larger cheque number (10 digits from 5) and to reverse the
  88. amounts for credit and liability accounts (something I overlooked in the
  89. first beta's QIF converter).  Migration from 2.9b2 to 2.9b3 will 
  90. only update the version number in the card's base.dat file.
  91.  
  92. Automatic migration is relevant *only* to cards and accounts created with
  93. the first 2.9 beta.
  94.  
  95.  
  96.                                  IMPORTING
  97.                                  ~~~~~~~~~
  98. To import your existing pre-2.9 ET account files, follow these simple steps
  99. (WARNING:  do not have two copies of the program running concurrently; ET
  100. scans the task list for window titles in order to communicate with itself.
  101. If more than one copy exists, it will stop scanning at the first match,
  102. which may not be the newer version):
  103.  
  104. 1)  Open your existing pre-2.9 copy of ET
  105.  
  106.     i.   Open the folder containing the account(s) to be exported.  
  107.     ii.  Select the account to export.  
  108.     iii. Select 'Export to QIF...'  from the 'Accounts' 'Maintenance'
  109.          submenu.  
  110.     iv.  Check the 'Regular transactions', 'Categories', 'Classes' boxes in
  111.          the 'ET Converter' dialog.  
  112.     v.   Click 'OK' to invoke the file dialog, and enter a filename.  
  113.     vi.  Repeat steps i through v for each account to be exported.
  114.       
  115. 2)  Close ET and open version 2.9.  
  116. 3)  Recreate the folder(s) into which you want the newly-exported Accounts
  117.     placed ('Cards -> New...').  
  118. 4)  Access the newly-created card and invoke the QIF importer ('Cards ->
  119.     Import QIF...').
  120.  
  121. The rest should be pretty self-explanatory with the exception of a few
  122. items.  On export, ET will use the system's country settings in creating
  123. the date, so it is possible to have (for 31 Jan.  1995) one of the
  124. following three formats:
  125.  
  126.     1/31/95     (US) 
  127.     31/ 1/95    (European) 
  128.     95/ 1/31    (Canadian)
  129.  
  130. Rather than guess at what format is used in the QIF file (or assume that it
  131. corresponds to the system's country settings), the converter will display
  132. the first transaction in the Date Format dialog with the date parsed in
  133. accordance with the default (US) format.  If it looks right, then click
  134. 'OK'.  Otherwise, use the 'Up' 'Down' buttons to shift the date elements to
  135. reflect the format, and click 'OK'.  If the format is incorrect, the
  136. converter will import records until it reaches a date with an element out
  137. of range.  For example, if the US (mm/dd/yy) format was used when, in fact,
  138. the European (dd/mm/yy) format ought to have been used, as soon the
  139. converter reaches a date whose month exceeds 12, a fatal error will be
  140. raised and the conversion stopped.
  141.  
  142. IMPORTANT QIF IMPORT STRATEGY:  automatic (re)linking takes place during
  143. import.  So, if you are importing 10 accounts, for example, and one account
  144. is linked to all 10 at some point, then one of two things will happen:
  145.  
  146. 1) if the account to which a transaction is linked does not exist, a flag
  147. will be set for the transaction before it is added to the account being
  148. imported so that it can be easily retrieved when the link account is later
  149. imported.  
  150.  
  151. 2) if a link account already exists, one of the index files will be scanned
  152. for a possible match to relink the new transaction with an existing one.
  153. If a match does not exist, a new transaction will NOT be created.  Instead,
  154. it will be logged in a separate window and displayed along with any other
  155. failed links when the last imported record is complete.  For each failed
  156. relink, an entry in the window will appear as follows:
  157.  
  158.     SOURCE ACCOUNT:     <Name of account being imported>
  159.     TARGET ACCOUNT:     <Name of account link account>
  160.     DATE (mm/dd/yyyy):  date of transaction in US format
  161.     [NUMBER:            cheque number]    --| these are mutually exclusive
  162.     [CODE:              transaction code] --| and appear if applicable
  163.     PAYEE/DESCRIPTION:  transaction particulars
  164.     AMOUNT:             amount of transaction
  165.     CLASS:              (only if applicable)
  166.     MEMO:               (only if applicable)
  167.     ----------------------------------------------------------------------
  168.  
  169. The information in the window can either be saved to file or printed.  If
  170. it is deemed that this transactions should be rekeyed, then you will have
  171. some knowledge of what goes where.
  172.  
  173. 3) If a match is found, relinking will take place automatically.
  174.  
  175. In order for a match to be deemed valid, all but the category and amount
  176. fields of the source and link transactions must correspond exactly.  If a 
  177. match is not found with an exact date comparison, then the date will be 
  178. expanded to the source transaction's month (that is to say, regardless of 
  179. the actual day within the month).  If still no match is found, the link 
  180. will be considered failed, and the source transaction logged to the dialog 
  181. mentioned above.
  182.  
  183. Previously, I suggested that the order of imported accounts might prove 
  184. important, and it has, but not for the reasons I gave, i.e. a time-saver. 
  185. The QIF Converter was reworked again for the 3rd beta and the a number of 
  186. accounts imported in random order.  The outcome was always the same, and 
  187. correct.
  188.  
  189.                            USAGE - SERVICE DESK
  190.                            ~~~~~~~~~~~~~~~~~~~~
  191. The Service Desk remains largely unchanged with the exception of sizeable
  192. container windows (position the mouse over the vertical bar, press RMB &
  193. drag).
  194.  
  195. The 'Folders' paradigm has changed in 2.9 for two reasons:  
  196.  
  197. 1) folders don't quite make sense for a program called 'Electronic Teller',
  198. but an ATM (Automatic Teller Machine) card does; 
  199. 2) I hope that moving away from the 'Folders' term will clear up the
  200. confusion that has existed in the past, e.g.  Why can't I move accounts to
  201. another folder?  etc.  Like all ATM cards, ET's cards can be set up to
  202. access many accounts, and you can access other accounts on other cards if
  203. these are setup as such, but that's about the extent of it.  At any rate,
  204. setting up new cards remains largely unchanged with the exception of
  205. terminology.
  206.  
  207. Creating accounts is slightly different in two respects:
  208.  
  209. 1) The date field has been replaced by a calendar.  Selecting the date in
  210. the calendar is sufficient to inform ET that the initial transaction is to
  211. be dated that selected date.
  212.  
  213. NOTE:  initial transaction dates are treated loosely in 2.9.  Although an
  214. account's creation date can be 1 Jan.  1996, for example, with a starting
  215. balance of $1.00, a subsequent addition to the account on 31 Dec.  1995 to
  216. the amount of $2.00 will transfer the creation date from Jan.  1 to Dec 31
  217. as well as the initial balance.
  218.  
  219. 2) Closing the notebook creates the account.  This is to ensure that the
  220. notebook is more CUA compliant.  If the account name entryfield is left
  221. blank, no account will be created.
  222.  
  223.  
  224.                            USAGE - ACCOUNT BOOK
  225.                            ~~~~~~~~~~~~~~~~~~~~
  226. The Account Book has changed dramatically from an end-user point of view.
  227. The single container has been placed into a notebook and replaced by an
  228. owner-drawn listbox.  The notebook will contain pages for each year a
  229. transaction in the account exists, from latest to earliest.  This means
  230. that, for an account with transactions spanning 1995 to 1996, two pages
  231. will be initially displayed in reverse order (1996, 1995).  All records for
  232. 1996 will be loaded into the listbox on startup.  The 1995 records will be
  233. loaded only if the notebook page is selected.  The amount of records loaded
  234. per pass is determined by the size of the listbox window.  If, for example,
  235. it is estimated that the window will contain 50 records, the records will
  236. be enumerated approximately 50 at a time (the date determines the actual
  237. number, but it will never be less than the amount of records that can fit
  238. in the visible portion of the listbox) with a one-half second pause in
  239. between each load, until all records are loaded.  The one-second pause
  240. exists to allow the user to perform duties while the loading process is
  241. underway, so that he/she doesn't have to sit idly while ET is churning
  242. away.
  243.  
  244. ET manages this by serializing access to the data files.  Although tests 
  245. have shown pretty good stability, here, it's a good idea not to try 
  246. invoking a function before something appears in the listbox.
  247.  
  248. Many of the icons have also been changed.  Two reasons for this.  First of
  249. all, I lost all my old icons following a complete C:  drive failure.
  250. Second, the old ones were, well frankly, somewhat ugly.  If in doubt, watch
  251. the status area of the window while moving the pointer over the icon.  It
  252. should tell you what its purpose is.
  253.  
  254. Some buttons in the button bars are also somewhat specialized, providing
  255. access to different functions depending upon the state of the Ctrl key when
  256. the button is clicked.  The trashcan button, for example, will delete
  257. transactions or, if deleted transaction are selected, shred them.  If the
  258. Ctrl key is depressed when this button is clicked, the selected
  259. transactions will be restored, or undeleted.  Again, watch the status area
  260. for clues.  A word about shredding:  SHREDDED RECORDS CANNOT BE RESTORED.
  261.  
  262.  
  263.                        USAGE - CREATING TRANSACTIONS
  264.                        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  265. Major changes, here, too.  The notebook has been replaced by a single and
  266. more straightforward (I hope) dialog box.  Moreover, it is no longer
  267. possible to add transactions to multiple accounts in a single session.  All
  268. transactions are added to the account from which the dialog was invoked (or
  269. the selected account if invoked from the Service Desk).
  270.  
  271. To create a transaction (from the Transaction dialog), follow these steps:
  272.  
  273. 1) Double-click on a calendar date
  274.  
  275.     OR  go to the date field and use the Up/Down; Ctrl+Up/Ctrl+Down keys to
  276.         scroll to the desired date
  277.  
  278.     OR  enter the date manually.
  279.  
  280. If you opt for the 3rd option, enter it correctly, in accordance with your
  281. system's country settings, i.e.  mm/dd/yyyy or dd/mm/yyyy or yyyy/mm/dd.
  282.  
  283. 2) Go to the Number field and enter either a cheque number of a transaction
  284. code, i.e.  ATM.  Line completion is available here, so if ATM already
  285. exists, typing 'A' will expand the field to to first code matching that
  286. prefix.
  287.  
  288.     OR  if a cheque, simply enter '!'  (without the single quotes).  This 
  289.         will assign the next cheque number in the series to the Number 
  290.         entryfield when you go to another field.
  291.  
  292.     OR  press the F2 key to get a popup listbox of existing transaction 
  293.         codes
  294.  
  295.     OR  right-click anywhere in the entryfield for the list
  296.  
  297.     OR  press the Up/Down keys to scroll the existing list
  298.  
  299. Any numeric value entered into this entryfield is considered a cheque.  A
  300. numeric value is anything that begins with a number, e.g.  123ABC will be
  301. interpreted as cheque #123.  On the other hand, ABC123 will be considered a
  302. code in its entirety.
  303.  
  304. 3) Go to the payee field and enter the payee or particulars.  If a
  305. memorized transaction exists for this information, the field will be
  306. expanded to contain that information (as well as the credit or debit,
  307. category, class, and memo fields).  If the transaction code field is blank,
  308. it, too, will be given a value if one exists for the memorized record.
  309.  
  310.     OR  press F2 to get a list of existing memorized transactions
  311.  
  312.     OR  right-click in the window for a view of that list.
  313.  
  314.     OR  press the Up/Down keys to scroll the existing list
  315.  
  316. If a memorized transaction exists, is displayed, and contains a cheque
  317. number, you will be asked if you would like the next cheque number in the
  318. series applied to the item.  Replying 'Yes' will assign the next number to
  319. the Number field.  'No' assigns the memorized number to the Number field.
  320.  
  321. If you choose not to accept the memorized transaction, press F3 to undo the
  322. changes made by the expansion.  All but the 'Particulars/Payee' fields will
  323. be returned to their state prior to the expansion.
  324.  
  325. 4) Enter a value in the Credit field
  326.  
  327.     OR  enter a value in the debit field.
  328.  
  329. If both fields are 0, you will be requested to confirm the transaction
  330. before it is entered into the container.
  331.  
  332. If both fields contain a value that is not zero, the transaction will be
  333. rejected.
  334.  
  335. 5) Tab to the category field and enter your data (line completion applies)
  336.  
  337.     OR  press F2 for a list of existing categories
  338.  
  339.     OR  right-click anywhere in the entryfield for a list of existing 
  340.         categories
  341.  
  342.     OR  press the Up/Down keys to scroll the existing list
  343.  
  344. 6) Tab to the class field and enter your data (line completion applies)
  345.  
  346.     OR  press F2 for a list of existing classes
  347.  
  348.     OR  right-click anywhere in the entryfield for a list of existing 
  349.         classes
  350.     
  351.     OR  press the Up/Down keys to scroll the existing list
  352.  
  353. 7) Tab to the memo field and enter your data
  354.  
  355. 8) Click 'Append' to create a regular transaction
  356.  
  357.     OR  click 'As Split' to create a split transaction for the selected 
  358.         regular (or parent) record in the container
  359.  
  360. Splits must have a valid parent record selected in the transaction
  361. container.  If none is selected or exist, the 'As Split' button will be
  362. disabled.  When a split is created, it will be added to the container as a
  363. child of the parent, in standard OS/2 container usage, i.e.  a + enclosed
  364. within a box will appear to the left of the parent container record.
  365. Expand the container to view, or edit, or 'Remove' splits.
  366.  
  367. New records that appear in the transaction container are not actually
  368. written to file until the 'OK' button is clicked to dismiss the dialog.
  369. This allows you the opportunity of making changes, removing records, etc.
  370. before actually committing the records to file.
  371.  
  372. Once a record has been 'Append'ed to the container, you can then elect to
  373. memorize it (by checking the 'Memorize' box) or postdate it (by checking
  374. the 'Postdate' box).
  375.  
  376.  
  377.                       USAGE - POSTDATING TRANSACTIONS
  378.                       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  379. Postdated transactions appear in the account ledger using a half-toned text
  380. attribute -- it's slightly more difficult to read, but *is* readable and
  381. clearly denotes a postdated entry.  The amount of the transaction is not
  382. tabulated into the overall balance.
  383.  
  384. To postdate a transaction, first select it from the transaction container,
  385. and click the 'Postdate' checkbox.  If the transaction is successfully
  386. postdated, the box will remain checked.  You can either remove postdating
  387. by unchecking the box, or edit the postdated options by clicking the 'Edit
  388. postdate...'  button.
  389.  
  390. Postdating transactions is somewhat different from previous versions of ET.
  391. Most important is that postdated options are saved in 'setups'.  In order
  392. to postdate a record, a setup must either already exist, or one must be
  393. created.  When the Postdate dialog is invoked on a transaction that has not
  394. yet been postdated, it's 'Particulars/Payee' information will be displayed
  395. and suggested as a postdate setup name.  If such a setup already exists,
  396. the options previously defined will be preselected.  You can either leave
  397. them unchanged or make alterations.
  398.  
  399. WARNING:  any changes made to a setup has a card-wide affect.  That is to
  400. say, if you change the frequency of an existing setup entitled 'First of
  401. Month', all records making use of that 'First of Month' setup will be
  402. affected.  Similarly, if you delete the 'First of Month' setup, all records
  403. making use of that setup will no longer be postdated!
  404.  
  405. NOTE:  the calendar/reminder utility shares the postdate dialog but its
  406. setups are independent of all ATM cards.  IOW, deleting a reminder setup
  407. has no effect on any transaction in any account on any card.
  408.  
  409. All postdate options are preserved when the dialog is dismissed.  So,
  410. making changes to an existing setup are not preserved if the 'Cancel'
  411. button is clicked.  Similarly, options for a new setup are preserved when
  412. 'OK' is clicked.  To create a new setup, enter a name in the combobox and
  413. click 'Add'.  To delete an existing setup, select it from the combobox and
  414. click 'Delete'.  To change a setup's name only, select it in the combobox,
  415. make the necessary changes, and click 'Change'.
  416.  
  417. There are now four possible postdate frequency options:
  418.  
  419. 1) ONE TIME
  420.  
  421.     Select this option if the transaction is postdated but is not to be
  422.     repeated after the expiry date is reached.
  423.  
  424. 2) SIMPLE
  425.  
  426.     This is the simplest to set up.  Any combination of the three spin- 
  427.     buttons (Days, Months, Years) is permitted.  So, setting them to:
  428.  
  429.         Days <1> Months <2> Years <3>
  430.  
  431.     will advance the transaction's next date to 3 years, 2 months, and 1 
  432.     day from the moment day it becomes due.
  433.  
  434.     The maximum values for each spinbutton are:
  435.  
  436.         Days:  31 Months:  11 Years:  99
  437.  
  438. 3) RECURRING DATE
  439.  
  440.     There are two spinbuttons in the 'Date options' groupbox with possible
  441.     values enclosed within angled brackets:
  442.  
  443.         On the <1st to 31st> 
  444.         of every <month>, <2nd to 11th month>, <Jan to Dec>
  445.  
  446.     The first spinbutton represents an actual monthly calendar date.  If 
  447.     you select the '31st' obviously not every month has 31 days.  ET will
  448.     assume that you mean on the last of month and adjust the next date
  449.     accordingly.
  450.  
  451.     The second spinbutton can be set to repeat monthly '<month>', every <x>
  452.     month, or every specific month '<Jan> ...  <Dec>'.  The syntax should 
  453.     guide you in creating a valid postdated transaction.
  454.  
  455. 4) RECURRING WEEKDAY
  456.  
  457.     This is the most flexible of all, but also the most difficult to setup.
  458.     There are three spin buttons, with possible values enclosed within 
  459.     angled brackets:
  460.  
  461.         On <1st to 4th>, <last> <Sun to Sat> 
  462.         of every <week>, <2nd to 4th week>, <month>, <2nd to 11th month>
  463.  
  464.     Again, let the syntax be your guide.  If you are creating an entry for 
  465.     a bi-weekly paycheque, deposited into your account every second Friday,
  466.     then you would spin the buttons as follows:
  467.  
  468.         On <---> <Fri> of every <2nd wk>
  469.  
  470.     If, on the other hand, your account is deducted on a specific day of 
  471.     the month, every month, and, if that day happens to be the last Monday 
  472.     of the month, you would spin the buttons as follows:
  473.  
  474.         On <last> <Mon> of every <month>
  475.  
  476.     A number of verifications are made before postdated options are 
  477.     accepted:
  478.  
  479.         1)  the transaction's initial date of the month must correspond to 
  480.             the postdated date of the month, where applicable.  
  481.  
  482.         2)  the transaction's week in the month must correspond
  483.             to the postdated week option, where applicable.  
  484.  
  485.         3)  the transaction's weekday must correspond to the postdated 
  486.             option's weekday, where applicable.
  487.  
  488.  
  489.                        USAGE - EDITING TRANSACTIONS
  490.                        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  491. To edit one or more transactions, select them from the Account Book, and
  492. select the 'Edit...'  menu item
  493.  
  494.     OR  press <Enter>
  495.  
  496.     OR  press and hold the Ctrl key and click the transaction button
  497.  
  498.     OR  invoke the transaction dialog and drag selected records into the
  499.         transaction container while holding the 'Ctrl' key
  500.  
  501. Any of these actions will invoke the Transaction dialog into which the
  502. selected records will be displayed in the container.  Double-click on the
  503. records to recall their values into the entryfields, make the changes and
  504. click 'Change'.
  505.  
  506. Changes are not actually committed to file until the dialog is dismissed by
  507. clicking the 'OK' button.  You can, if you wish, add additional records by
  508. following the above procedures or by holding the Ctrl key and dragging one
  509. or more transactions from the Account Book container into the Transaction
  510. dialog's container.  You can also also create additional records at this
  511. time by following the instructions outlined in the 'Usage - Creating
  512. Transactions' topic.
  513.  
  514. There is no limit on the number of transactions that can be created and/ or
  515. edited in one session.  The only limitation is that all transactions are
  516. destined for the same account, and additional instances of the dialog are
  517. not permitted.
  518.  
  519.  
  520.                       USAGE - RECONCILING AN ACCOUNT
  521.                       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  522. Account reconciliation has been greatly simplified, as well.  The
  523. cumbersome dialog of pre-2.9 has been replaced by a more user-friendly
  524. version.  The dialog itself is divided into two parts:  
  525.  
  526.     1) entryfields, 
  527.     2) listbox.
  528.  
  529. The entryfields are used to specify certain necessary pieces of information
  530. required for a valid reconciliation:
  531.  
  532.  
  533. Previous balance:  specifies the ending balance at the last recon-
  534. ciliation, or the accounts starting balance if working from a new account,
  535. or the sum of all cleared transactions if working from an imported QIF file
  536.  
  537. Increase by:  specifies all credits that should be applied to the
  538. account being reconciled, such as interest payments made to you during the
  539. period between the last reconciliation and the reconciliation date or any 
  540. other item that increases the account's balance.
  541.  
  542. Decrease by:  specifies all debits that should be applied to the account
  543. being reconciled, such as fee payments deducted from your account or
  544. charged to your account; in short, all items that deduct from an account's 
  545. balance.
  546.  
  547. New balance:  specifies the balance as it appears on your statement.
  548.  
  549. Statement:  is the date upon which the reconciliation is to take place.
  550. Typically, this will mirror the date of the statement.
  551.  
  552. When these data are entered, you can begin clearing transactions by
  553. double-clicking on those that are to be cleared (or selecting them and
  554. pressing <Enter>).  Cleared transactions are denoted by a check mark to the
  555. left of the transaction.  To unclear a transaction, simply double-click on
  556. it a second time.  (Un)clearing a transaction automatically moves the
  557. cursor to the next record.  If there are more transactions in the listbox
  558. than will appear in the window, the window will be scrolled so that it is
  559. situated at the second-to-top-most position in the listbox (this may take
  560. some getting used to).
  561.  
  562. As transactions are cleared, the (+), (-), and (=) status areas of the
  563. window will be adjusted to reflect the total credits, debits, and balance
  564. respectively.  When the (=) area's amount matches that entered in the 'New
  565. balance' entryfield, ET will consider the reconciliation to be accurate 
  566. and will sound a beep. Any difference between these two amounts will be 
  567. reported when the 'Reconcile' button is clicked, allowing you to abort the
  568. final stages.  Of course, adjust the 'New balance' manually will fool ET
  569. into thinking that all is well, but this is not a recommended practice.
  570. The oversight is intentional, however -- a sort of fudge factor that is
  571. there if absolutely necessary.
  572.  
  573.  
  574.                            USAGE - DRAG AND DROP
  575.                            ~~~~~~~~~~~~~~~~~~~~~
  576. Version 2.9 makes extensive use of OS/2's drag & drop capabilities.  ET
  577. complies with the standard OS/2 drag & drop options, e.g.
  578.  
  579.     Move = drag button 
  580.     Copy = Ctrl + drag button 
  581.     Link = Shift + Ctrl + drag button
  582.  
  583. Here, briefly, is a list of what can be done:
  584.  
  585.     Move    ... permitted to any opened account book on the same card
  586.  
  587.             ... permitted to any account icon in the Service Desk on the 
  588.                 same card
  589.  
  590.             ... disallowed if the source and target accounts are the same 
  591.                 (obviously)
  592.  
  593.             ... permitted when dragging an ATM card or selected accounts 
  594.                 to the shredder
  595.  
  596.     Copy    ... permitted to any opened account book or account icon in 
  597.                 the Service Desk, including the source of the drag, but not 
  598.                 to accounts on different cards
  599.  
  600.             ... permitted when dragging selected transactions to the 
  601.                 transaction dialog container.
  602.  
  603.             ... permitted when dragging an ATM card or selected accounts 
  604.                 to the shredder
  605.  
  606.     Link    ... see below
  607.  
  608.             ... permitted when dragging an ATM card or selected accounts 
  609.                 to the shredder
  610.  
  611. Links require special consideration given the fact that a listbox is used
  612. rather than a container, which means that there is no sure way of knowing
  613. if a record has been dropped on a record or white space.  Here are the
  614. following rules for valid linking:
  615.  
  616. 1) If the source window has multiple records selected, the target must not
  617. have any selected.  An accepted drop will copy the selected source
  618. records into the target account and link them.
  619.  
  620. 2) If the source window has one record selected as does the target window,
  621. no new record will be created; rather the source will be linked to the
  622. target and neither record values will be altered, with the exception of the
  623. category which will reflect the linked account's name within square
  624. brackets.
  625.  
  626. The long and the short of this is:  if you want to link with an existing
  627. transaction in the target account, select it before initiating the drag.
  628. If you want to duplicate records from the source in the target account,
  629. deselect all records in the target and select the relevant records in the
  630. source before initiating the drag.
  631.  
  632.  
  633.                                  FIRST AID
  634.                                  ~~~~~~~~~
  635. If your account(s) appear to suffer irrevocable damage, have a look at the
  636. first-aid option from the Service Desk.  Selecting an account and invoking
  637. first aid will allow you to repair three things:
  638.  
  639.     1) ending balance or ('Sums') 
  640.     2) damaged index files ('Indices') 
  641.     3) forward balance error ('Balance')
  642.  
  643. Electronic Teller maintains a sums table for every year an account has a
  644. transaction, and displaying a running balance is largely contingent upon
  645. the accuracy of this table.  If your running balance appears to be off,
  646. click the 'Sums' button in the first aid dialog.
  647.  
  648. To speed things along, ET uses index files.  The bulk of the data, however,
  649. is kept in the *.REC file in the ATM card's directory.  If this key file
  650. ever becomes corrupted, you have only a backup to fall back upon.  If, on
  651. the other hand, one or more index files become corrupted, click the
  652. 'Indices' button in the first aid dialog.  This will read the entire *.REC
  653. file and reconstruct the indices, sums table, and forward balance.
  654.  
  655. Reconciliation depends a great deal upon an accurate forward balance (your
  656. initial balance when the account is first created or your last reconciled
  657. balance).  This can be repaired by clicking the 'Balance' button in the
  658. first aid dialog.
  659.  
  660. Of course, there's nothing as safe as a backup, and ET makes this process
  661. even safer by creating an ascii file of the card's entries from the
  662. etdeskf.ini file -- a global ATM card file used to save such things as the
  663. sums table I mentioned above.  This ascii file can be used to reconstruct a
  664. card's INI entries with the 'restini.exe' utility.  What this utility will
  665. do is read the 'etdeskf.rc' file, restoring code handles and names,
  666. memorized transaction handles and structures, category handles and
  667. structures, class handles and names, cheque design structures, postdated
  668. setups, as well as the budget entries (budgeted and actual amounts) and the
  669. accumulated bank fees.  Do not rely on this utility completely, because it
  670. is only as good as the last backup.
  671.  
  672.  
  673.                                   BUDGETS
  674.                                   ~~~~~~~
  675. Budgets are complete.  If budgets exist for your categories in the QIF
  676. file, then they will be automatically imported by the QIF converter.  Note,
  677. however, that ET will permit multiple budgets, based upon a year.  So, it
  678. is possible, therefore, to have a budget for a subcategory named
  679. 'Utilities:Electricity' for both 1995 and 1996.  During import, the current
  680. system year is always used.
  681.  
  682. To create a budget, you must invoke the Settings notebook (Card -> Settings
  683. from the Service Desk), (Records -> Settings from the Account Book), or
  684. 'Settings' in the Transaction dialog.  The page labelled 'Budgets' contains
  685. a number of controls.  Simply select the category for which the budget is
  686. to be created and enter the appropriate amounts in the twelve entryfields.
  687. Click 'Save' to save the budget amounts for that category.  You can copy an
  688. entire category budget from one year to another by selecting the budget and
  689. selecting the target year in the second spin button.  Click 'Copy' and then
  690. 'Save' to preserve the budget.  'Undo' will always revert to the previous
  691. amounts.
  692.  
  693. Budget graphs and printing are available from the Service Desk once an ATM
  694. card has been accessed.  Upon startup, the 'Summary' graph will be set as
  695. the default.  Clicking the 'ref' button to the right of the 'Trans.  Year'
  696. spin button will read in the relevant data from the account(s) and begin
  697. plotting the graph.  There are three types of graphs available:
  698.  
  699. 1 - Income or Expense Category
  700.  
  701. This will display a breakdown of the budgeted and actual amounts for a
  702. category throughout the entire 'Trans.  year'.  The 'Budget year' will be
  703. used for purposes of comparison.
  704.  
  705. 2 - Income or Expense Group
  706.  
  707. Depending upon the list of categories displayed, this option will total the
  708. budgeted and actual amounts for each displayed category and display a
  709. breakdown of those totals for each month of the 'Trans.  year', using the
  710. 'Budget year' budget.
  711.  
  712. 3 - Summary
  713.  
  714. This graph will display a total of the following six items:
  715.  
  716.     i   - Budgeted Income 
  717.     ii  - Actual Income 
  718.     iii - Budgeted Expense 
  719.     iv  - Actual Expense 
  720.     v   - Budgeted Income less Expense 
  721.     vi  - Actual Income less Expense
  722.  
  723. To view graph #1, simply double-click on the desired category in the
  724. listbox.  To view graph #2, click the 'Group' button.  And, to view graph
  725. #3, click the 'Summary' button.  To apply a budget defined for another year
  726. to the transac- tions for a specific year, spin the 'Budget year' button
  727. and click the 'ref' button to the right of that button to refresh the
  728. display.  To view results for a specific transaction year, spin the 'Trans.
  729. year' button and click the 'ref' button to its right to refresh the
  730. display.  Depending upon the amount of records for a given year, refreshing
  731. the transaction year can take anywhere from a few seconds to a minute or
  732. more.  The process is threaded, and can be cancelled at any time by
  733. clicking the 'Close' button.  Summary and Group graphs are also threaded
  734. and can also be cancelled by clicking the 'Close' button.  Only the
  735. accounts which are selected in the 'Accounts' listbox will be included into
  736. the actuals amounts for both graphing and printing.
  737.  
  738. To print a budget, click the 'Print...'  button, select a printer (the
  739. printer will be remembered from session to session), select what type of
  740. category to include in the budget report (either Income and/or Expense),
  741. and, if you would like empty budgets (those that have neither a budget or
  742. actual amount for the entire year) included, check the 'Include empty' box.
  743. Click 'Print' to begin the process.  Click 'Cancel' to abort the print job.
  744.  
  745. What is included in a budget graph and report is any transaction with a
  746. valid category.  This includes regular and split transactions.  ET does not
  747. differentiate between a regular and split transaction, so if a category is
  748. specified for both the regular transaction and each split, duplication will
  749. occur.  What is not included in the actuals totals are records that have
  750. been flagged for deletion or postdated transactions.
  751.  
  752.  
  753.                                   REPORTS
  754.                                   ~~~~~~~
  755. Creating a report is a simple matter of selecting the accounts from the ATM
  756. card, selecting the desired type, and specifying a 'From:' and 'To:' date 
  757. range.  This is commong to all report types.  Some types require additional
  758. user-interaction.
  759.  
  760. Five report types are available:
  761.  
  762.     1)  Transaction
  763.     2)  Budget
  764.     3)  Cheque Usage
  765.     4)  Unreconciled Records
  766.     5)  Transaction Fees
  767.  
  768.  
  769. TRANSACTION reports list account contents in the following order:
  770. ~~~~~~~~~~~
  771.         Date    Code  Description  Memo  Category  Clr Amount
  772.  
  773. Date        contains the transaction's date, formatted in accordance with 
  774.             the system's country settings.
  775. Code        contains either the transaction's cheque number of code, e.g. 
  776.             ATM.
  777. Description is the transaction's payee or particulars.
  778. Memo        is what it states
  779. Category    is a combination of category:subcategory/class or whatever
  780.             will fit on the line.
  781. Clr         will be either blank if the transaction is neither cleared nor 
  782.             a split; 'X' if the transaction is cleared; '-s-' if the 
  783.             transaction represents a split.
  784. Amount      is a signed amount
  785.  
  786.  
  787. A number of subtotalling options for this report are available. 
  788. These are:
  789.  
  790.     1) None
  791.     2) Weekly
  792.     3) Two weeks
  793.     4) Half month
  794.     5) Monthly
  795.     6) Quarterly
  796.     7) Six months
  797.     8) Yearly
  798.     9) Category (family)
  799.    10) Category (single)
  800.    11) Class
  801.    12) Payee
  802.  
  803. The 'Category (family)' option subtotals by an entire category type, e.g.
  804. transactions using, for example, "Utilities:Electricity" and
  805. "Heating:Electricity" will be subcategorized individually.  The categories
  806. that are included are selected by the user, and only those that appear in
  807. the selected account(s) are made available.
  808.  
  809. The 'Category (single)' option subtotals by individual category items. 
  810. For example, if the 'Electricity' subcategory were selected, the two 
  811. category families "Utilities:Electricity" and "Heating:Electricity" 
  812. would be subtotalled together, since they share a common child, i.e. 
  813. "Electricity."  Again, the categories that are included in the report are 
  814. user-selected.
  815.  
  816. Subtotalling by Class and Payee is also user-selectable.  That is to
  817. say, only those classes and payees for which a transaction exists will be
  818. made available, and those that are selected will be included in the report.
  819.  
  820.  
  821. BUDGET reports subtotal by category thus:
  822. ~~~~~~
  823.     Category        Budget      Actual      Difference      Mth
  824.  
  825.                                                             Jan
  826.                                                             Feb
  827.                                                             Mar
  828.                                                             Apr
  829.                                                             May
  830.                                                             Jun
  831.                                                             Jul
  832.                                                             Aug
  833.                                                             Sep
  834.                                                             Oct
  835.                                                             Nov
  836.                                                             Dec
  837.  
  838. The first step in creating a budget report is selecting the categories that
  839. are to be included, both from the 'Income' and the 'Expense' lists.  If you
  840. wish to omit a category type entirely, simply uncheck the box beneath the 
  841. list.  The next step is selecting the months that are to be included for 
  842. each budget and actual months.  These are preselected based upon the 
  843. previously selected date range, but can be changed prior to generating the 
  844. budget report.  Any unselected month will be assigned budget, actual, and 
  845. difference values of 0 to avoid skewed or incorrect totals.
  846.  
  847.  
  848. CHEQUE USAGE reports make use of the same format as the Transaction report.
  849. ~~~~~~~~~~~~
  850. A Cheque Usage report picks all the transactions within the date range that
  851. contain a valid cheque number.  Numbers are listed in reverse order and any
  852. missing or duplicate cheques are enumerated at the bottom of the report.  A
  853. special note about duplicate cheques:  if a link exists for a cheque, and 
  854. both the source and link accounts are included in the report, then a 
  855. duplicate entry will appear.  This erroneous duplication could be avoided, 
  856. but would require additional code to overcome what could be seen as a 
  857. feature.
  858.  
  859.  
  860. UNRECONCILED RECORDS reports make use of the Transaction report format.
  861. ~~~~~~~~~~~~~~~~~~~~
  862. This report lists all records that have yet to be cleared.  Rather than 
  863. leave the 'Clr' column blank, three dashes (---) appear so that a manual 
  864. checking can be performed if desired.
  865.  
  866. TRANSACTION FEES reports makes use of Electronic Teller's transaction fees
  867. ~~~~~~~~~~~~~~~~
  868. The Transaction Fees report also makes use of the Transaction report 
  869. format, except each defined transaction code, e.g. ATM, WIT, etc. is 
  870. grouped on a per-month basis, and after each month for each code, a 
  871. breakdown like the following is shown:
  872.  
  873. (1)    ATM transactions for August 1996:               10
  874. (2)    Free transactions per month:                     3 
  875. (3)    Free exceeded by:                                7
  876.  
  877. (4)    Minimum monthly balance:                    700.00
  878. (5)    Minimum balance required:                 1,000.00
  879. (6)    Amount owing if balance met:                  3.50
  880. (7)    Amount owing if balance shortfall:           10.00
  881.                                                  ========
  882. (8)    Total owing:                                 10.00
  883.  
  884.  
  885. The numbered lines are as follows:  (1) is the number of codes found for 
  886. the month; (2) the amount of free transactions defined in the Settings 
  887. notebook for this code per month; (3) the number of transactions exceeding 
  888. the free count; (4) the account's minimum monthly balance; (5) the minimum 
  889. monthly balance required to qualify for 'Free' transactions, as defined in 
  890. the Settings notebook; (6) the amount owing if the minimum monthly balance
  891. is met (amount * (total count - exceeded count)); (7) the amount owing if
  892. the minimum monthly balance was not met (amount * total count); (8) the
  893. total amount owing for the given code for the given period -- either (6) or
  894. (7) but not both.  In the above example, it is assumed that each 'ATM'
  895. transaction costs 1.00 on a balance shortfall and .50 if the balance is
  896. met.  Ten transactions were found with a minimum monthly balance of 700.00,
  897. 300.00 less than the required minimum.  Because the miminum balance has 
  898. not been met, the cost associated with the shortfall is assigned to the 
  899. 'Total owing' (8) row, or 10.00.  If the balance had been maintained, then 
  900. the amount owing would have been 3.50 ( .50 * ( 10 - 3 ) ).
  901.  
  902. At the end of the report, all the (8) are tabulated to present an overall 
  903. total of all transaction fees for the defined period.
  904.  
  905.  
  906. TRANSACTION FEES
  907. ~~~~~~~~~~~~~~~~
  908. To create transaction fees, select an account from the Service Desk or open
  909. an account book, and invoke the settings notebook.  The final page, 
  910. entitled 'Fees' will be displayed.  Simply turn to that page.  You will see
  911. a list of all codes defined for the account.  Select then codes for which a
  912. fee is to be created, and tab to the first of the four entry fields below. 
  913. These are:
  914.  
  915. (1)    Free items per month:
  916. (2)    Minimum balance req'd:
  917. (3)    Cost if balance not met:
  918. (4)    Cost if balance met:
  919.  
  920. (1) represents a count of items for which no charge is attached if the 
  921. minimum monthly balance is met.  In other words, this item affects only the
  922. 'Cost if balance met' item.  (2) represents the minimum monthly balance 
  923. used to determine if the count of items should be adjusted and whether a 
  924. cost should be applied to the '...balance not met' or '...balance met' 
  925. items.  (3) represents the charge per transaction if the minimum monthly 
  926. balance is met (cost * (total count - free count)).  (4) represents the 
  927. cost if the minimum monthly balance is not met ( cost * total count).
  928.  
  929. Transaction fees are relevant to individual accounts in individual ATM 
  930. cards.
  931.  
  932.  
  933.                               CHEQUE PRINTER
  934.                               ~~~~~~~~~~~~~~
  935. When the cheque printer dialog is first invoked, two listboxes appear with 
  936. associated buttons beneath each.  The left box, 'Queued cheques' contains a
  937. list of all cheques transactions that were selected prior to invoking the 
  938. printer.  'Designs' contains a list of all existing designs.  Initially, 
  939. this listbox will be empty.  In order to print cheques, a design must first
  940. be created.  Do so by following these steps:
  941.  
  942. 1)  Click 'Create...'
  943. 2)  Assign the design a name ('Design:')
  944. 3)  Specify the number of cheques per page.  This number is used in both 
  945.     determining the amount of space between cheques on multiple cheques 
  946.     printing and in deciding when to send the printer a new page command.
  947.     Possible values range from 1 to 5 or continuous.  The 'continuous'
  948.     option means, simply, that no new page code will be sent to the
  949.     printer; instead, it will be assumed that the cheques are not on
  950.     indidivual sheets of paper but on continuously fed paper.
  951. 4)  Determine the dimensions of an individual cheque in millimeters.  
  952.     these are important in two respects:  (1) the width will determine the
  953.     amount of space cheque fields can be dragged.  If you require an 
  954.     unusual left margin, you can increase the width of the cheque to create
  955.     greater horizontal space.  The height is important in determining the
  956.     spacing in between cheques if more than one cheque exists per page.
  957. 5)  The 'Window scale:' is used solely to accomodate the design window
  958.     to your display so that the size can more closely match the actual
  959.     cheque dimensions.  On my display (small font @ 1024x768), the scale
  960.     of 4 is ideal.  Possible values range from 1 to 10.
  961. 6)  If the cheque number is to be printed, check the 'Print cheque number'
  962.     box.
  963. 7)  If the dates are to be combined, e.g. '1 Jan 96' rather than '1 Jan' 
  964.     and '96' as separate fields, check the 'Combine date fields' box.
  965. 8)  If your cheques accomodate stubs, check the 'Cheque includes stub'
  966.     box.
  967. 9)  Drag the fonts you want to use for the individual cheque fields to
  968.     the Cheque Design cheque fields.  Because the font use will affect
  969.     the positioning of the printed item, it's a good idea to do this
  970.     before actually dragging fields.
  971. 10) Begin positioning the individual fields.  Bear in mind that the 0x0
  972.     coordinate corresponds to the lower left-hand side of the window.  So,
  973.     measure your fields from bottom left to top right.  Bear in mind, 
  974.     also, that the X:  and Y:  coordinates are merely an approximation; and
  975.     so this is mostly a trial and error sort of endeavour.  To test your
  976.     design, click the 'Test...'  button on the 'Design Setup' dialog.
  977.     The status area of the window will inform you of a field's position
  978.     and font as the mouse is moved over the field.  The 'X:' field 
  979.     reports the item's horizontal position, from the left-hand side of
  980.     the window; the 'Y:' field reports the item's vertical position from
  981.     the bottom of the window.
  982.  
  983. Once you have created one or more designs, select the one you want to use 
  984. for the printing session, and click 'Print...'  If you wish to remove any 
  985. cheques from the print list, simply select them and click 'Remove'.  As 
  986. each cheque is spooled, a check mark will appear to the left of the item.
  987.  
  988.  
  989.                            SEARCHING & REPLACING
  990.                            ~~~~~~~~~~~~~~~~~~~~~
  991. To search and optionally replace transaction data, click on the magnifying 
  992. glass in an account book.  This will invoke the 'Search and Replace' dialog
  993. from which a search is defined and an optional replacement string 
  994. specified.
  995.  
  996. Any of the following 6 transaction fields can be searched:
  997.  
  998.     1) Number or Code
  999.     2) Payee or Description
  1000.     3) Amount
  1001.     4) Category
  1002.     5) Class
  1003.     6) Memo
  1004.  
  1005. And, any of the following 3 transaction status options can be applied:
  1006.  
  1007.     1) Deleted
  1008.     2) Postdated
  1009.     3) Voided
  1010.  
  1011.  
  1012. The desired option is selected from the 'Field' combination box.  If the 
  1013. 'Status' is set to 'None', then no filtering is performed during a search.
  1014. That is to say, any record matching the search criteria, regardless of 
  1015. whether it is cleared, deleted, postdated, uncleared, or voided, will be 
  1016. included in the results list.
  1017.  
  1018. If a status is specified, then only those transactions which meet the 
  1019. status requirement will be considered for inclusion into the results list. 
  1020. If a 'Search' criterion is also specified, then the transactions in 
  1021. question must also meet thosee requirements.  NOTE:  that no search
  1022. criterion need be entered when searching for transactions of a given
  1023. status.  If the 'None' status is selected, then a search string must be
  1024. provided in order for the search to take place.
  1025.  
  1026. Next, a date range for the search is entered.  The 'to' date is inclusive. 
  1027. As elsewhere in Electronic Teller, the [Ctrl] PageUp/ [Ctrl] PageDown keys 
  1028. can be used to cycle the date by [month] and day.
  1029.  
  1030. The 'Search' is where the search string is entered.  If you are searching a
  1031. code, payee, category, or class, you can right-click in the search field
  1032. (or tab to it and press F2) to get a list of existing items.
  1033. Alternatively, you can enter any complete or substring.  
  1034.  
  1035. If you wish to limit the search by case or exact match, check the 
  1036. appropriate boxes beneath the 'Search' entryfield.  If the case checkbox is
  1037. left unchecked, the search and found strings will be converted to uppercase
  1038. prior to examination.  If the exact box is left unchecked, the found string
  1039. will be searched to determine if it contains the substring specified by
  1040. 'Search'.  Thus, a payee search of 'wit' will result in a hit for all
  1041. payees containing that string, e.g.  withdraw, withold, Joe Witaker, etc.
  1042.  
  1043. If you wish to search split transactions, ensure that the 'Omit splits in 
  1044. search' box is left unchecked.  By default, splits not included in 
  1045. searches, although they are not available if specifying a status criterion,
  1046. since, by definition, if the parent is deleted, postdated, or voided, so,
  1047. too, are the splits.
  1048.  
  1049. Before any 'Replace' can take place, the search must first be executed.  A 
  1050. replace can then proceed only if at least one 'hit' was made.  If you 
  1051. attempt to replace a code, category, or class with an item that does not 
  1052. exist, you will be asked if you would like to create that item.  If you
  1053. answer No, the replacement will not take place.
  1054.  
  1055. The 'Options' menu contains a number of options, much like those that are 
  1056. found in all account books' 'Record' menu.  You can, for example, delete or
  1057. undelete, shred, void or restore, create or edit transactions.  The same 
  1058. text attribute and colour sequence used in account books is also used in 
  1059. results list box.
  1060.  
  1061.  
  1062.